Accessors for Low-Memory Globals1

Inside Macintosh: Macintosh Toolbox Essentials

Previous | Chapter Top | Chapter Contents | Next |

Accessors for Low-Memory Globals

You should never access low-memory globals directly. Instead, use a high-level Event Manager function, if one is available. If a high-level function is not available, you can use one of the accessors described here.

LMGetKeyRepThresh

Returns a value that specifies the value of the auto-key rate.



 
pascal SInt16 LMGetKeyRepThresh (void);

DESCRIPTION

LMGetKeyRepThresh returns a signed 16-bit integer that describes the value of the auto-key rate, that is, the amount of time, in ticks, that must elapse before the Event Manager generates a subsequent auto-key event.

ASSEMBLY-LANGUAGE NOTE

The value obtained by LMGetKeyRepThresh is also accessible in the system global variable KeyRepThresh .

LMSetKeyRepThresh

Sets the low-memory auto-key rate.



 
pascal void LMSetKeyRepThresh (SInt16 value);

value: A signed 16-bit integer that specifies the low-memory auto-key rate.

DESCRIPTION

LMSetKeyRepThresh specifies a signed 16-bit integer that sets the low-memory e the value of the auto-key rate, that is, the amount of time, in ticks, that must elapse before the Event Manager generates a subsequent auto-key event.

ASSEMBLY-LANGUAGE NOTE

The value set by LMSetKeyRepThresh is also accessible in the system global variable KeyRepThresh .

LMGetKeyThresh

Returns a value that specifies the low-memory auto-key key threshold.



 
pascal SInt16 LMGetKeyThresh (void);

DESCRIPTION

LMGetKeyThresh returns a signed 16-bit integer that describes the value of the auto-key threshold, that is, the amount of time, in ticks, that must elapse before the Event Manager generates an auto-key event.

ASSEMBLY-LANGUAGE NOTE

The value obtained by LMGetThresh is also accessible in the system global variable KeyThresh .

LMSetKeyThresh

Sets the auto-key threshold.



 
pascal void LMSetKeyThresh (SInt16 value);

value: A signed 16-bit integer that specifies the low-memory auto-key threshold.

DESCRIPTION

LMSetKeyThresh specifies a signed 16-bit integer that sets the low-memory auto-key threshold, that is, the amount of time, in ticks, that must elapse before the Event Manager generates an auto-key event.

ASSEMBLY-LANGUAGE NOTE

The value set by LMSetKeyThresh is also accessible in the system global variable KeyRepThresh .

LMGetSEvtEnb

Returns a value that specifies the system event enabled bit



 
pascal UInt8 LMGetSEvtEnb (void);

DESCRIPTION

LMGetSEvtEnb returns a signed 16-bit integer that describes the low-memory system event enabled bit, a byte that, if set to 0, causes the SystemEvent function (SystemEvent) to always return false .

ASSEMBLY-LANGUAGE NOTE

The value obtained by LMGetSEvtEnb is also accessible in the system global variable SEvtEnb .

LMSetSEvtEnb

Sets the low-memory system event enabled bit.



 
pascal void LMSetSEvtEnb (UInt8 value);

value: An unsigned 8-bit integer that describes the value of the system event enabled bit.

DESCRIPTION

LMSetSEvtEnb specifies an unsigned 8-bit integer that sets the low-memory system event enabled bit, , a byte that, if set to 0, causes the SystemEvent function (SystemEvent) to always return false .

ASSEMBLY-LANGUAGE NOTE

The value set by LMSetSEvtEnb is also accessible in the system global variable SEvtEnb .

LMGetSysEvtMask

Returns a value that describes the low-memory system event mask.



 
pascal SInt16 LMGetSysEvtMask (void);

DESCRIPTION

LMGetSysEvtMask returns a signed 16-bit integer that describes the low-memory system event mask of the current application.

ASSEMBLY-LANGUAGE NOTE

The value obtained by LMGetSysEvtMask is also accessible in the system global variable SysEvtMask .

LMSetSysEvtMask

Sets a specified value for the system event mask.



 
pascal void LMSetSysEvtMask (SInt16 value);

value: A signed 16-bit integer that specifies the value for the system event mask of the current application.

ASSEMBLY-LANGUAGE NOTE

The value specified by LMSetSysEvtMask is also accessible in the system global variable SysEvtMask .

LMGetTicks

Returns a value that describes the low-memory ticks global variable.



 
pascal SInt32 LMGetTicks (void);

DESCRIPTION

LMGetTicks returns a signed 16-bit integer that describes the current number of ticks since the system last started up. For details on functions that let you obtain data about timing, see "Getting Timing Information" .

ASSEMBLY-LANGUAGE NOTE

The value obtained by LMGetTicks is also accessible in the system global variable Ticks .

LMSetTicks

Specifies a value for the low-memory ticks global variable.



 
pascal void LMSetTicks (SInt32 value);

value: A signed 32-bit integer that specifies thenumber of ticks since the system last started up .

ASSEMBLY-LANGUAGE NOTE

The value specified by LMSetSysEvtMask is also accessible in the system global variable SysEvtMask .